SetConditionalFormatting(Int32,Int32,IConditionalFormattingRule[]) Method

Sets conditional formatting for a specified cell on the sheet based on specified rules.

Syntax

Visual Basic
C#

'Declaration
 
Public Overloads Sub SetConditionalFormatting( _
   ByVal row As Integer, _
   ByVal column As Integer, _
   ByVal ParamArray rules() As IConditionalFormattingRule _
)

'Usage
 
Dim instance As SheetView
Dim row As Integer
Dim column As Integer
Dim rules() As IConditionalFormattingRule
 
instance.SetConditionalFormatting(row, column, rules)

public void SetConditionalFormatting( 
   int row,
   int column,
   params IConditionalFormattingRule[] rules
)

Parameters

row: Row index
column: Column index
rules: Rules to apply for the specified cell

Example

This example creates a conditional rule.

private void Form1_Load(object sender, EventArgs e)
    {
        fpSpread1.Sheets[0].Cells[0, 0].Value = 3;
        fpSpread1.Sheets[0].Cells[1, 0].Value = 2;
        fpSpread1.Sheets[0].Cells[1, 1].Value = 10;
        fpSpread1.Sheets[0].Cells[0, 2].Value = 1;
    }

    private void button1_Click(object sender, EventArgs e)
    {
        FarPoint.Win.Spread.Model.CellRange celRange1 = new FarPoint.Win.Spread.Model.CellRange(0, 0, 3, 3);
        FarPoint.Win.Spread.ThreeColorScaleConditionalFormattingRule rule = new FarPoint.Win.Spread.ThreeColorScaleConditionalFormattingRule(Color.Aqua, Color.Bisque, Color.BlueViolet);
        fpSpread1.Sheets[0].SetConditionalFormatting(new FarPoint.Win.Spread.Model.CellRange[] { celRange1 }, rule);
        //or
        //FarPoint.Win.Spread.Model.CellRange celRange1 = new FarPoint.Win.Spread.Model.CellRange(0, 0, 3, 3);
        //FarPoint.Win.Spread.Model.CellRange celRange2 = new FarPoint.Win.Spread.Model.CellRange(0, 4, 2, 2);            
        //FarPoint.Win.Spread.ThreeColorScaleConditionalFormattingRule rule = new FarPoint.Win.Spread.ThreeColorScaleConditionalFormattingRule(Color.Aqua, Color.Bisque, Color.BlueViolet);
        //fpSpread1.Sheets[0].SetConditionalFormatting(new FarPoint.Win.Spread.Model.CellRange[] { celRange1, celRange2 }, rule);
        //or
        //FarPoint.Win.Spread.ThreeColorScaleConditionalFormattingRule three = new FarPoint.Win.Spread.ThreeColorScaleConditionalFormattingRule();
        //three.MidValue = new FarPoint.Win.Spread.ConditionalFormattingColorValue(Color.Aqua, 10, FarPoint.Win.Spread.ConditionalFormattingValueType.Number);
        //three.MinValue = new FarPoint.Win.Spread.ConditionalFormattingColorValue(Color.BlueViolet, 10, FarPoint.Win.Spread.ConditionalFormattingValueType.Number);
        //fpSpread1.Sheets[0].SetConditionalFormatting(1, 1, three);
    }

VB.NET

Private Sub Form1_Load(ByVal sender As System.Object, ByVal e As System.EventArgs) Handles MyBase.Load
        FpSpread1.Sheets(0).Cells(0, 0).Value = 3
        FpSpread1.Sheets(0).Cells(1, 0).Value = 2
        FpSpread1.Sheets(0).Cells(1, 1).Value = 10
        FpSpread1.Sheets(0).Cells(0, 2).Value = 1
    End Sub

    Private Sub Button1_Click(ByVal sender As System.Object, ByVal e As System.EventArgs) Handles Button1.Click
        Dim celRange1 As New FarPoint.Win.Spread.Model.CellRange(0, 0, 3, 3)
        Dim rule As New FarPoint.Win.Spread.ThreeColorScaleConditionalFormattingRule(Color.Aqua, Color.Bisque, Color.BlueViolet)
        FpSpread1.Sheets(0).SetConditionalFormatting(New FarPoint.Win.Spread.Model.CellRange() {celRange1}, rule)
        'or
        'Dim celRange1 As New FarPoint.Win.Spread.Model.CellRange(0, 0, 3, 3)
        'Dim celRange2 As New FarPoint.Win.Spread.Model.CellRange(0, 4, 2, 2)
        'Dim rule As New FarPoint.Win.Spread.ThreeColorScaleConditionalFormattingRule(Color.Aqua, Color.Bisque, Color.BlueViolet)
        'FpSpread1.Sheets(0).SetConditionalFormatting(New FarPoint.Win.Spread.Model.CellRange() {celRange1, celRange2}, rule)
        'or
        'Dim three As New FarPoint.Win.Spread.ThreeColorScaleConditionalFormattingRule()
        'three.MidValue = New FarPoint.Win.Spread.ConditionalFormattingColorValue(Color.Aqua, 10, FarPoint.Win.Spread.ConditionalFormattingValueType.Number)
        'three.MinValue = New FarPoint.Win.Spread.ConditionalFormattingColorValue(Color.BlueViolet, 10, FarPoint.Win.Spread.ConditionalFormattingValueType.Number)
        'FpSpread1.Sheets(0).SetConditionalFormatting(1, 1, three)
    End Sub

Requirements

Target Platforms: Windows 2000 Professional (SP4), Windows 2000 Server, Windows 2003 Server (SP1), Windows 2008, Windows XP (SP2), Windows Vista, Windows 7, Windows 8

Reference

SheetView Class
SheetView Members
Overload List